feat: MAUI integration hooks and refactor for 0.4.1 nuget by abelonogov-ld · Pull Request #425 · launchdarkly/observability-sdk

abelonogov-ld · 2026-03-19T15:23:14Z

Summary

Refactors the Android Observability SDK architecture to align with the iOS/Swift and MAUI integration patterns, decoupling the Observability plugin from SessionReplay so each can function independently.

Architectural Changes

Decoupled plugin dependency direction: SessionReplayService can depend on Observability, but Observability no longer depends on SessionReplay. Removed InstrumentationContributor, InstrumentationContributorManager, and the LDExtendedInstrumentation-based registration flow.
Renamed for parity with Swift: ReplayInstrumentation → SessionReplayService, ReplayControl → SessionReplayServicing.
Simplified log processing pipeline: Removed RoutingLogRecordProcessor and the per-instrumentation log routing mechanism from InstrumentationManager, since it was only used by session replay and no longer needed.
SessionManager exposed via context: InstrumentationManager now captures the OTel SessionManager via a lightweight bridge AndroidInstrumentation and exposes it through ObservabilityClient → ObservabilityContext.sessionManager, matching the Swift pattern.

Session Replay Changes

Plugin lifecycle: SessionReplay.register() directly creates SessionReplayService using LDObserve.context, wires it to LDReplay, and sets the hook delegate. SessionReplay.onPluginsReady() calls sessionReplayService.initialize() after SessionManager is available.
Hook refactoring: SessionReplayHook no longer holds a reference to the SessionReplay plugin. Instead, it uses a @Volatile delegate of type SessionReplayServicing and extracts context keys from SDK types before delegating.
afterIdentify moved to service layer: Context key extraction and LDContext building now happen in SessionReplayService.afterIdentify() and SessionReplayHook.afterIdentify() respectively, using a Map<String, String> interface for cross-platform compatibility.
New SessionReplayHookProxy: JVM adapter for the C#/MAUI bridge that accepts simple JVM types and delegates to SessionReplayServicing.
Wake-up events: Added RRWebEventGenerator.generateWakeUpEvents() and SessionReplayExporter.wakeUpEvents() to re-trigger player playback after session resumption with a reload event and synthetic mouse interactions.
Title propagation: RRWebEventGenerator now accepts a title parameter used in reload custom events, derived from the application name.

New Utilities

AttributeConverter: Converts untyped Map<String, Any?> dictionaries (from bridge layers like .NET MAUI) into OTel Attributes, with support for nested map flattening via dot-separated keys and typed list handling.

Note

Medium Risk
Medium risk due to refactoring plugin wiring and session replay export behavior (new wake-up payloads) plus removal of custom instrumentation/log-routing hooks, which could affect initialization order and telemetry/replay delivery.

Overview
Refactors the Android Observability + Session Replay integration to remove the LDExtendedInstrumentation contributor flow and instead initialize Session Replay directly from the SessionReplay plugin, while Observability now captures and shares the OTel SessionManager via LDObserve.context.

Session Replay is renamed/reshaped into SessionReplayService/SessionReplayServicing, with identify handling routed through a delegate-based SessionReplayHook plus a new MAUI-friendly SessionReplayHookProxy. Replay exporting now propagates an app title, emits a one-time “wake-up” payload (reload + synthetic interactions) after pushing events, and sets client_id to observability-android in the replay session init call.

Adds bridge-friendly APIs for MAUI: LDObserve.recordLog(message, severityNumber, attributesMap) / recordError(message, cause) backed by a new AttributeConverter (flattening nested maps and typing lists). Updates e2e UI copy and benchmark generator construction, and simplifies/updates tests to match the new architecture.

^{Written by Cursor Bugbot for commit cae622e. This will update automatically on new commits. Configure here.}

* main: feat: Optional Jet Compose (#402) feat: Android Incremental Image Diff compression (#390) chore: add CLAUDE.md (#398) chore: release main (#400) fix: correct react native session replay build step (#399) chore: release main (#396) fix: Android span e2e tests (#397) fix: improve network response capture (#379) # Conflicts: # sdk/@launchdarkly/mobile-dotnet/.vscode/tasks.json

(cherry picked from commit f883e975ca79da891b4178d8a12e27868f0931eb)

* main: chore: release main (#401)

(cherry picked from commit 9901600)

* main: chore: release main (#406) feat: Make Android SDK35 compilable (#405)

* andrey/hooks: comment identify stuff fat working working can launch

* main: chore: release main (#419) feat: Use C and NEON for hashing (Optimization) 100x on Pixel 8 (#415) chore: release main (#418) feat: Android SR use Jpeg 0.3 quality (#417) chore: release main (#411) feat: CPU utilization optimization in image diff calculations (#414) fix: reset nodeIds during fullsnapshot (#412) chore: Android benchmark screen of SR data pipelines on iOS Raw Frames (#410) feat: Android Observability hook proxy for MAUI (#409) feat: ruby observability plugin (#360) # Conflicts: # sdk/@launchdarkly/mobile-dotnet/android/native/LDObserve/src/main/java/com/example/LDObserve/ObservabilityBridge.kt # sdk/@launchdarkly/mobile-dotnet/macios/native/LDObserve/Sources/ObservabilityBridge.swift # sdk/@launchdarkly/mobile-dotnet/observability/LDAPI/LDObserve.cs # sdk/@launchdarkly/mobile-dotnet/observability/LDObservability.Fat.csproj # sdk/@launchdarkly/mobile-dotnet/observability/LDObservability.csproj # sdk/@launchdarkly/mobile-dotnet/observability/bridge/LDObserve.cs # sdk/@launchdarkly/mobile-dotnet/observability/bridge/NativeHookProxy.cs # sdk/@launchdarkly/mobile-dotnet/observability/observe/api/LDObserve.cs # sdk/@launchdarkly/mobile-dotnet/observability/observe/plugin/ObservabilityHook.cs # sdk/@launchdarkly/mobile-dotnet/observability/observe/plugin/ObservabilityPlugin.cs # sdk/@launchdarkly/mobile-dotnet/observability/replay/plugin/SessionReplayHook.cs # sdk/@launchdarkly/mobile-dotnet/observability/replay/plugin/SessionReplayPlugin.cs # sdk/@launchdarkly/mobile-dotnet/sample/MauiProgram.cs

* main: feat: mobile-dotnet support init attributes (#420) # Conflicts: # sdk/@launchdarkly/mobile-dotnet/observability/LDObservability.Fat.csproj # sdk/@launchdarkly/mobile-dotnet/observability/LDObservability.csproj # sdk/@launchdarkly/mobile-dotnet/observability/bridge/DictionaryTypeConverters.cs

(cherry picked from commit a56660e)

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

* main: build: use cocopods instead of swift package manager in podspec (#431) fix: handle bool type in FormatAttributes (#430) chore: [SEC-7924] pin third-party GitHub Actions to commit SHAs (#429)

…servability-sdk into andrey/recordlog-android * 'andrey/recordlog-android' of github.com:launchdarkly/observability-sdk:

🤖 I have created a release *beep* *boop* --- <details><summary>launchdarkly-observability-python: 1.2.0</summary> ## [1.2.0](launchdarkly-observability-python-1.1.0...launchdarkly-observability-python-1.2.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> <details><summary>launchdarkly-observability-android: 0.32.0</summary> ## [0.32.0](launchdarkly-observability-android-0.31.0...launchdarkly-observability-android-0.32.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) * MAUI integration hooks and refactor for 0.4.1 nuget ([#425](#425)) ([33f6d6c](33f6d6c)) </details> <details><summary>go: 1.1.0</summary> ## [1.1.0](go/v1.0.0...go/v1.1.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> <details><summary>launchdarkly-observability-dotnet: 1.1.0</summary> ## [1.1.0](launchdarkly-observability-dotnet-1.0.0...launchdarkly-observability-dotnet-1.1.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> <details><summary>observability: 1.1.0</summary> ## [1.1.0](observability-1.0.3...observability-1.1.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) ### Dependencies * The following workspace dependencies were updated * dependencies * highlight.run bumped to 9.28.0 </details> <details><summary>observability-node: 1.1.0</summary> ## [1.1.0](observability-node-1.0.1...observability-node-1.1.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> <details><summary>observability-react-native: 0.8.0</summary> ## [0.8.0](observability-react-native-0.7.1...observability-react-native-0.8.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> <details><summary>session-replay: 1.1.0</summary> ## [1.1.0](session-replay-1.0.3...session-replay-1.1.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) ### Dependencies * The following workspace dependencies were updated * dependencies * highlight.run bumped to 9.28.0 </details> <details><summary>session-replay-react-native: 0.3.0</summary> ## [0.3.0](session-replay-react-native-0.2.2...session-replay-react-native-0.3.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) ### Dependencies * The following workspace dependencies were updated * dependencies * @launchdarkly/observability-react-native bumped to 0.8.0 </details> <details><summary>highlight.run: 9.28.0</summary> ## [9.28.0](highlight.run-9.27.1...highlight.run-9.28.0) (2026-03-26) ### Features * **@launchdarkly/session-replay-react-native:** use cocoapods for native session replay ([#434](#434)) ([41988e1](41988e1)) </details> --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).  --- > [!NOTE] > **Low Risk** > Low risk: this is a Release Please version/changelog bump across packages with no functional code changes beyond version constants and manifests. > > **Overview** > Cuts a new coordinated release by bumping versions across Go, web/Node/React-Native, Android, .NET, Python, Session Replay, and `highlight.run`, updating `.release-please-manifest.json` and each package’s `CHANGELOG.md`. > > Also updates package metadata/version declarations (e.g., `package.json`, `pyproject.toml`, `gradle.properties`, `.csproj`, and Go `InstrumentationVersion`) and notes the `highlight.run` dependency bump to `9.28.0`. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 26333ff. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>

abelonogov-ld added 30 commits February 25, 2026 20:35

rearrange files

dcbe7dd

Empty session replay plugin

ae11179

renaming

a357362

empty hooks

fd062ea

EvalHook

605fe0f

add comment

c73c0bc

Android hooks started working

b5587e7

match to iOS

957795b

remove dependencies

52e3a3c

0.27.0

4af8770

(cherry picked from commit f883e975ca79da891b4178d8a12e27868f0931eb)

Merge branch 'main' into andrey/hooks

858041f

* main: chore: release main (#401)

separate start

0c55a45

make SDK35 compilable

c4280e2

forgotten dependency

8bca813

(cherry picked from commit 9901600)

Merge branch 'main' into andrey/hooks

fbf5c1a

* main: chore: release main (#406) feat: Make Android SDK35 compilable (#405)

can launch

08ffef7

working

4d48233

fat working

057dc85

comment identify stuff

2fd116b

hook proxy

68f9dc7

Merge branch 'andrey/hooks' into andrey/android-hooks

8f20444

* andrey/hooks: comment identify stuff fat working working can launch

demo plugin

5fa9867

last suggestion

1bb1d87

matching versions

f664bd9

small fixes

0682e76

3.11

3b9b3e0

3.13

3b7d577

update

7e07e89

add xcuserdata to .gitignore for mobile-dotnet SDK

b9ef80d

abelonogov-ld added 11 commits March 4, 2026 13:24

add tasks.json to .prettierignore

7d45595

launching from local dotnet core

7801dec

attirbutes working

dcff8eb

support init attributes

76cf0f6

reverse Android change

1a08b6c

forgotten files

e9a3d7e

Remove build pattern for options

f17ae86

move file

194cfba

Refactor to be close to iOS and MAUI integration hook

9f888c8

abelonogov-ld requested a review from a team as a code owner March 19, 2026 15:23

cursor Bot reviewed Mar 19, 2026

View reviewed changes

abelonogov-ld changed the title ~~feat: MAUI integration hooks~~ feat: MAUI integration hooks and refactor Mar 19, 2026

remove printing in system

abac43e

cursor Bot reviewed Mar 19, 2026

View reviewed changes

Comment thread e2e/android/app/src/main/java/com/example/androidobservability/BaseApplication.kt

Comment thread .../lib/src/main/kotlin/com/launchdarkly/observability/replay/exporter/SessionReplayExporter.kt

abelonogov-ld added 2 commits March 19, 2026 13:39

Android MAUI update

27d2002

(cherry picked from commit a56660e)

Merge branch 'main' into andrey/recordlog-android

b79b772

cursor Bot reviewed Mar 25, 2026

View reviewed changes

Comment thread .../lib/src/main/kotlin/com/launchdarkly/observability/replay/exporter/SessionReplayExporter.kt

abelonogov-ld changed the title ~~feat: MAUI integration hooks and refactor~~ feat: MAUI integration hooks and refactor for 0.4.1 nuget Mar 25, 2026

Vadman97 approved these changes Mar 26, 2026

View reviewed changes

abelonogov-ld enabled auto-merge (squash) March 26, 2026 17:44

Merge branch 'main' into andrey/recordlog-android

d8bc660

abelonogov-ld disabled auto-merge March 26, 2026 18:43

abelonogov-ld added 2 commits March 26, 2026 12:12

Merge branch 'main' into andrey/recordlog-android

59d6848

* main: build: use cocopods instead of swift package manager in podspec (#431) fix: handle bool type in FormatAttributes (#430) chore: [SEC-7924] pin third-party GitHub Actions to commit SHAs (#429)

Merge branch 'andrey/recordlog-android' of github.com:launchdarkly/ob…

cae622e

…servability-sdk into andrey/recordlog-android * 'andrey/recordlog-android' of github.com:launchdarkly/observability-sdk:

abelonogov-ld merged commit 33f6d6c into main Mar 26, 2026
24 checks passed

abelonogov-ld deleted the andrey/recordlog-android branch March 26, 2026 21:34

LaunchDarklyReleaseBot mentioned this pull request Mar 26, 2026

chore: release main #435

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: MAUI integration hooks and refactor for 0.4.1 nuget#425

feat: MAUI integration hooks and refactor for 0.4.1 nuget#425
abelonogov-ld merged 50 commits into
mainfrom
andrey/recordlog-android

abelonogov-ld commented Mar 19, 2026 •

edited by cursor Bot

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

abelonogov-ld commented Mar 19, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Architectural Changes

Session Replay Changes

New Utilities

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

abelonogov-ld commented Mar 19, 2026 •

edited by cursor Bot

Loading